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Preface 



This document is intended to be ultimately expanded into a 
User's Guide to DAD. In the mean time, it is primarily a 
command summary with some explanation of needed concepts in an 
attempt to provide enough information so that people can use 
the debugger. 

Statements that are marked with a vertical bar character ( ! ) 
in the right margin have been editted since the last release 
(10 Sep 76 3rd Draft) of this document. Most of these 
changes are internal cosmetic changes. The only content 
changes are the addition of the two appendices and the 
changing of the table of contents to refer to page numbers 
rather than statement numbers. 
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Syntax Conventions Used In This Document 

With the exception of the formal definition of an address list 
(which uses a modified BNF) , the following syntactical 
conventions are adhered to in the command summaries: 

Command words appear as first letter of the word being 
upper case and the rest of the word in lower case. When a 
generic function character (discussed below) is a command 
word, it will be surrounded by double quotation marks 
("..."). 

Noise words appear as lower case words enclosed in 
parentheses. 

Alternative paths through a rule or command appear as 
statements at the same level in a plex. 

The end of a command or rule is indicated by a colon (:). 

An upper case word preceded by an atsign (§) is a reference 
to a rule described elsewhere. 

An upper case word preceded by an uparrow (~) is a 
reference to a selection entity. Selection entity types 
(text, character, etc.) are listed in a separate branch. 

An uppercase word preceded by an asterick (*) refers to 
that character currently serving the generic function 
(discussed below) specified. 

An uppercase word not preceded by an atsign or uparrow is a 
builtin CLI construct (e.g. OK). 

Angle brackets (<>) are used to inclose single character 
keystrokes (e.g. <LINEFEED> refers to hitting the linefeed 
key on a terminal) . 
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Concepts j 2 

Entering and Leaving DAD ! 2a 

The following discussion is relevalant to the current 
release of the debugger and may change in the future. 

To use DAD, run the TENEX subsystem <ARCSUBSYS>DAD. When 
DAD starts, it will do some initialization and then prompt 
you with the DAD hereald followed by the prompt for a 
command. DAD's command language is context dependent, and 
until you have specified a tool for DAD to debug, only a 
few global commands will be available. Probably the most 
useful command at this time is the Debug command in which 
you specify which tool (i.e. which TENEX subsystem) you 
wish to debug. After specifying a tool, the full 
compliment of DAD's commands will be avaiable. At this 
time you may set breakpoints, examine memory, etc. When 
you are ready to start execution, give the Continue command 
and execution will start at the tool's main entry vector 
location. (If you do not wish to start at the main entry 
vector location, you may use some of the sub-commands of 
the Continue command.) 

To get back to DAD later (in case you forgot to set any 
breakpoints, or your program is looping, etc.), use the "L 
facility. Control-L is a deferred pseudo-interrupt (PSD, 
which means that you won't actually enter the debugger 
until the control-L is read. If you wish to enter the 
debugger immediately, type 2 control-Ls without any 
intervening typein. To continue execution of what was 
happening before you re-entered DAD use the Continue 
command . 

When you are through debugging, you may either enter a "C 
or use DAD's Quit command. If you are through debugging a 
specific (instance of a) tool and wish to debug (a 
different instance of or) another tool, use the Done 
command which will ask you for a new tool to be debugged 
after cleaning up the previous tool. 
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Tools, Processes, Languages, Etc. ! 2b 

The debugger is designed to be a multi-tool, multi-process, 
multi-machine, multi-high level language debugger. What 
this glorious statement means is: 

The debugger is able to debug more than one tool at a 
time, and in fact, able to debug tool interactions. 

(If you don't know what a tool is, you are in 
trouble, but see other NSW documentation for a 
definition . ) 

Any tool is allowed to contain any internal process 
structure it desires, and the debugger is able to debug 
more than one process. 

(Process is being used in the conventional computer 
science meaning of the word.) 

Some tools may be capable of running on more than one 
machine, or different tools may run on different 
machines. The debugger is capable of coping with this 
situation . 

And lastly, the debugger is capable of accepting from, 
and presenting to, the user data structures in a format: 
that resembles the (hopefully) high level language in 
which the tool was coded. 

To cope with this multitude of entities, the debugger uses 
the concept of an Internal Debugger Handle (IDH). An IDH 
is an unique (per debugging session) positive integer. 
Each process that the debugger knows about is assigned an 
IDH. A user may always refer to a process by its IDH, and, 
in some commands, if the process is the top process for a 
tool, the user may also refer to it by the tool's usename 
(see NSW documentation). 

A process is assigned an IDH when the debugger first 
learns of the process. When the debugger is first 
pointed at a tool, it will determine the process 
structure for that tool and assign an IDH for each 
process. Thereafter, the debugger will monitor the 
tool's execution, and will assign new IDHs to newly 
created processes at the time they are created. 
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The debugger is not capable of debugging a tool that is 
split on more than one machine. This means that the 
debugger is capable of debugging a tool on one machine for 
one instance of the tool, and on a different machine for a 
separate instance of the tool, but for any one instance, 
the entire tool must exist on one, and only one, machine. 

At any instance, the debugger can be pointed at one, and 
only one, process. This process will be referred to as the 
current or active target process. This does not mean that 
the debugger can not know about more than one process, nor 
that the debugger is not capable of varying the current 
target process over time. It just means that at any 
instance, all commands are refering to the current process 
(with the obvious exception of the Debug command to point 
at another process). During a debugging session, when a 
breakpoint is encountered, the process containing the 
breakpoint will automatically be made the current target 
process, regardless of which process was current 
previously. 
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Character Sets and Generic Functions i 2c 

Since the debugger is designed to support a number of 
different languages, and since most languages do not use 
the same character sets as valid characters in identifiers, 
etc., it is not possible for the debugger to always use the 
same character to mean the same thing in a command. For 
example, a semi-colon character may be a valid character in, 
an identifier in some languages, and it cannot therefore be 
used to separate address ranges (discussed below, but for 
now they are composed of expressions which may contain 
identifiers) in an address list. Therefore the debugger 
has adopted the concept of a generic fuction and a generic 
function character (GFC) . A GFC is that character which is 
currently serving a specific generic function. 

For documentation and communication purposes, it is 
convienient to have a generic name to refer to the 
character that is currently serving a specific generic 
function. Thus, while the specific character may change, 
it can still be refered to by its generic name. The 
generic name for a character is the uppercase word of the 
generic function symbolic name preceded by an asterick, 
e.g. the generic name for the GFC that is currently serving 
the generic function of an address list delimiter 
(semicolonchar) is *SEMIC0L0NCHAR. 

The current values of each GFC can be determined by using 
the Character (set) Display command. 

The symbolic names and the meaning of these generic 
functions are as follows (the debugger default character, 
in the absence of user or Language Module modification, for 
a generic function will appear under the meaning column 
delimited by a left angle bracket (<) and a right angle 
bracket followed by a semicolon (>;): 

generic function 

symbolic name meaning of character 



pluschar <+>; the user is using this character as 
the arithmetic addition operator 

minuschar <->; the user is using this character as 
the arithmetic subtraction operator 
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timeschar <*>; the user is using this character as 
the 

arithmetic multiplication operator 

dividechar <*>; the user is using this character as 
the 

arithmetic division operator 

lparenchar <(>; the user is using this character as 
the arithmetic left grouping character 

rparenchar <)>; the user is using this character as 
the arithmetic right grouping character 

blockchar <&>; the user is using this character as 



a 



BLOCKCHAR 



block delimiter; e.g. the string: 

string1&string2 
should be interpretted as symbol string2 
in block stringl if & is the current 



fieldchar <•>; the user is using this character to 
delimit the fields of a record 

escapechar <ALTM0DE or ESCAPE>; the user is using 
this 

character to mean interpret the. next 
character 



refers 
has 



as a debugger builtin variable; e.g., 
ESCAPECHAR followed by a T Q (or f q) 

to the builtin debugger variable which 

the value of the last displayed cell 



lmchar <%>; the user is using this character to 

mean 

interpret the next character(s) as a 
language module builtin variable or 

construct 

commachar <»>; the user is using this character as 

an 

address range delimiter to separate the 
two elements of an address range; under 
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normal circumstances, a LM will never see 
the COMMACHAR in user input strings 

semicolonchar <>>; the user is using this 
character to 

separate address ranges within address 

lists 

larrowchar < >; the user is using this character as 
tTTe debugger assignment character 

tabchar <tab> ; the user is using, this character 
to 

mean display the cell addressed by the 



most 



recently displayed cell 



poundchar <#>; the user is using this character to 

mean back up to the previous displayed 
cell 

If char <LINEFEED>; the user is using this 
character 

to mean display the next sequential cell 

uparrowchar <~>; the user is using this character to 
mean display the previous sequential cell 

bslashchar <\>; the user is using this character to 
mean 

display an address list in string mode 

equalchar <=>; the user is using this character to 
mean 

display the value of the input address 
list 

excmarkchar <!>; the user is using this character to 
mean 

display cells as ascii values 

lsquarechar <[>; the user is using this character to 
mean display an address list numerically 

qmarkchar <?>; the user is using this character to 
mean tell where symbols in an address 
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list 



are defined 



rsquarechar <]>; the user is using this character to 

mean display an address list as records 

slashchar </>; the user is using this character to 

mean display an address list 
symbollically 
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User Input and Debugger Output ' 2d 

All communication with the debugger is governed by the 
values of 4 records: the permanent and current input mode 
records, and the permanent and current output mode records. 
At the beginning of most commands (exceptions discussed 
below) the permanent input and output mode records are 
copied to the current input and output mode records, and 
thereafter the command is governed by the value of these 
current records. 

For example, all numbers entered by the user will be 
interpretted as being numbers in the base specified by 
the current input mode radix, and all numbers displayed 
to the user will be formatted to conform to the current 
output mode radix. 

(The only exception for these specific examples is 
that when specifying or viewing these radixes, the 
radix will always be interpretted as being decimal 
numbers . ) 

The values of the permanent input and output mode records 
can be displayed and viewed via the Typeout (mode) and 
Input (mode) commands. 

Several commands provide for modifying the current input 
and/or output mode records for a specific instance of a 
command. These ephemeral values are then lost at the start 
of the next command (see exceptions deiscussed below) . 

The exceptions mentioned above refer to the commands that 
consist of a single GFC, e.g. the assign command as entered 
by *LARROWCHAR. These commands will use the current values 
of the input and output mode commands at their beginning, 
i.e. the values of these records that were in effect for 
the previous command. 
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Address Lists i 2e 

Discussion ! 



2e1 



An address list is the basic manner in which a user 
refers to elements in the current target process. 
Basically, an address list is composed of one or more 
address ranges; and an address range consists of one or 
two address range elements (AREs). 

(The character that terminates an address list, while 
it may modify the functional use of the address list, 
is not a part of the address list itself.) 



10 
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Address List Terminators 

The user may terminate an address list with a number of 
different characters, depending on which command is 
being specified. The terminating character is NOT a 
part of the address list. The following are the generic 
characters, with their meaning, that may be used to 
terminate various address lists: 

generic character 
terminator meaning 



*2e2 



*LARR0WCHAR after each line of the address 
list is 

displayed, the user wishes to assign a 
new 

value to the just displayed entity 

*BSLASHCHAR the user wishes to see the 
address list 

displayed in string mode 

*EQUALCHAR the user wishes to have the value 

of the 

input address list displayed to him 

*EXCMARKCHAR the user wishes to see the 
address list 

displayed in ascii mode 

*LSQUARECHAR the user wishes to see the 
address list 

displayed in numeric mode 

*QMARKCHAR the user wishes to find out where 

the 

symbols in the entered address list are 
defined 

*RSQUARECHAR the user wishes to see the 
address list 

displayed in record mode 

*SLASHCHAR the user wishes to see the 

address list 

displayed in symbolic mode 
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*TABCHAR after displaying the current 

address 

list, the user wishes to see the cell (or 
data 

structure) addressed by the last 
dipslayed cell 



*POUNDCHAR 
address 

data 

prior 

(i.e. will 

*LFCHAR 
address 

data 

than 

structure) 

*UPARR0WCHAR 
address 

data 
structure) 



after displaying the current 
list, the user wishes to see the cell (or 
structure) taht was displayed immediately 
to the last cell (or data structure) 
perform an inverse *TABCHAR) 

after displaying the current 
list, the user wishes to see the cell (or 
structure) whose address is one greater 
the last displayed cell (or data 

after displaying the current 

list, the user wishes to see the cell (or 

structure) whose address is one less than 
the last displayed cell (or data 
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Formal Definition 



ADRLIST 
ADRRANGE 
BUILTIN 
FRAME 
/ JFN 



= ADRRANGE [ *SEMIC0L0NCHAR ADRLIST 
:= RANGE / BUILTIN / RECORDSPEC 



] / NULL 



2e3 



/ LOCAL / PARAM / SIGNAL / CATCH / MEM / PLIST 
/ ERR 

ERR := *ESCAPECHAR (»E / 'e) 
JFN := A JFN / RJFN 
AJFN := *ESCAPECHAR («J / »j) 
RJFN := AJFN. NUMBER [*COMMACHAR AJFN NUMBER] 
PLIST := *ESCAPECHAR (»Z / »z) 
MEM := AMEM / RMEM 
AMEM := *ESCAPECHAR ( »M / »m) 
RMEM := AMEM NUMBER [*COMMACHAR AMEM NUMBER] 
CATCH := *ESCAPECHAR (»C / 
SIGNAL := *ESCAPECHAR CS / 

= *ESCAPECHAR PP / 

= *ESCAPECHAR ( 'L / 



PARAM 

LOCAL 

FRAME 

FSPEC 

FF 

FR 

FO 

FT 

FB 

FA 



•c) 

•s) 
•P) 



= FSPEC [ 

= FF / FR / FO 
*ESCAPECHAR ( *F 
*ESCAPECHAR 
*ESCAPECHAR 
*ESCAPECHAR 
*ESCAPECHAR 
*ESCAPECHAR 



*COMMACHAR FSPEC 



RECORDSPEC 



(»F 
CF 
( ! F 
CF 

CF 



FT / 

f f) 

f f) 

f f) 

»f) 

•f) 

? f) 



FB / 



] 
FA 



( f + 

co 

( »T 

(»B 



/ 
/ 
/ 
/ 

NUMBER 



T t) 



[ NUMBER ] 



= EXPRESSION *FIELDCHAR EXPRESSION 
RANGE := EXPRESSION [ *COMMACHAR EXPRESSION ] 
EXPRESSION := 

an expression following the syntactical rules of the 
current language module, usualy composed of sums of 
terms, in which terms are composed of IDENTs 
IDENT := BLCKIDNT / SMPLIDNT / NUMBER / BLTNTRM / 
METAIDNT 

BLCKIDNT := SMPLIDNT *BLOCKCHAR SMPLIDNT 
SMPLIDNT := 

a string composed of valid identifier characters for 
the current language 
METAIDNT := *LMCHAR SMPLIDNT 

BLTNTRM : = BA / BB / BLN / BPN / BQ / BR / BY 
BA := *ESCAPECHAR ('A / »a) 
BB := *ESCAPECHAR ( »B / 'b) 
BLN := *ESCAPECHAR ( »L / 

:= *ESCAPECHAR ( »P / »p) 
= *ESCAPECHAR ( »Q / 
= *E3CAPECHAR ( f R / 
= *ESCAPECHAR ( 'Y / 

= a string of digits in the current input mode 



BPN 

BQ 

BR 

BY 

NUMBER 

radix 



NUMBER 
»1) NUMBER 
NUMBER 



•y) 
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AMEM := *ESCAPECHAR (»M / 'm) 

used to show the utilization of the address space of 
the target process 

RMEM := AMEM NUMBER [*C0MMACHAR AMEM NUMBER] 

used to show the utilization of the address space of 
the target process for pages NUMBER [to NUMBER] 

CATCH := *ESCAPECHAR ('C / f c) 

used to show the catchphrases for the current frame. 
SIGNAL := *ESCAPECHAR ( f S / »s) 

used to show the signal status of the process. 
PARAM := *ESCAPECHAR ( f P / »p) 



Semantics 

ADRLIST := ADRRANGE [ *SEMIC0L0NCHAR ADRLIST ] / NULL j 

the NULL address list is equivalent to entering the 
last input address list 

ERR := *ESCAPECHAR (»E / »e) ! 

used to show the last operating system error incurred 
by the current target process 

AJFN := *ESCAPECHAR ('J / 'j) ! 

used to display an indication of the files being used 

RJFN := AJFN NUMBER [*C0MMACHAR AJFN NUMBER] ! 

used to display an indication of the files being used 
for file numbers NUMBER [to NUMBER] 

PLIST := *ESCAPECHAR (»Z / »z) i 

used as a shorthand notation to be equivalent to the 
previously typed in address list 



2e4 
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used to show the formal parameters of the current 
frame 



LOCAL := *ESCAPECHAR (»L / '1) ! 

used to show the local variables of the current frame 

FF := *E3CAPECHAR ('F / »f) ! 

FF refers to the current frame, the current frame is 
the most recently displayed frame or the frame on the 
top of the stack after the debugger is entered 

FR := *ESCAPECHAR (»F / »f) (■ + / '-) [ NUMBER ] ! 

if NUMBER is not specified it defaults to 1 ; no 
spaces may precede NUMBER; NUMBER specifies the 
number of frames to move relative to the current 
frame; e.g. if '$ is the current *ESCPAECHAR, and ', 
is the current *C0MMACHAR, the FRAME: "$ft, $f-2 M 
would display the frame on the top of the stack, and 
the next two frames towards the bottom of the stack 
in the control thread. 

FO := *ESCAPECHAR ('F / »f) ('0 / »o) i 

used to show the owner frame of the current frame; 
the owner of a procedure is its caller; the owner of 
a coroutine is the routine that did the openport to 
the coroutine. 

FT := *ESCAPECHAR ('F / »f) (»T / *t) I 

used to show the top frame on the stack 
FB := *ESCAPECHAR (»F / »f) ('B / »b) ! 

used to show the bottom frame on the stack 
FA := *ESCAPECHAR («F / f f) '§ NUMBER ! 

used to show the frame whose mark is NUMBER 
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RECORDSHEC := EXPRESSION *FIELDCHAR EXPRESSION 

RECORDSPEC is used to represent a field (specified by 
the second EXPRESSION) of the record instance at the 
address specified by the first EXPRESSION; e.g. if 
period is the current *FIELDCHAR, then the 
RECORDSPEC: "rec.fld" refers to field "fid" of the 
record instance at address "red". 



BLCKIDNT := SMPLIDNT *BL0CKCHAR SMPLIDNT 

BLCKIDNT is used to refer to the (local) symbol 
(specified by the second SMPLIDNT) in the block (or 
file) specified by the first SMPLIDNT; e.g. if f & is 
the current *BLOCKCHAR, then the BLCKIDNT: 
"fl&sfilev" would refer to the symbol "sfilev" in 
file "fl" . 

METAIDNT := *LMCHAR SMPLIDNT 

METAIDNT is used to refer to language specific 
constructs, e.g. *LMCHAR COMMON to refer to the 
FORTRAN COMMON area; see the individual language 
guides for- which METAIDNTs are supported by the 
individual language packages 

BA := *ESCAPECHAR ( 'A / 'a) 

this entity has the value of the address of the most 
recently displayed cell 

BB := *ESCAPECHAR ('B / 'b) NUMBER 

this entity has the value of the address at which 
breakpoint NUMBER is set; it has the value of zero if 
breakpoint NUMBER is not set 

BLN := *ESCAPECHAR ( 'L / '1) NUMBER 

this entity has the value of the address of the 
NUMBER-th local of the current frame 

BPN := *ESCAPECHAR ('P / 'p) NUMBER 

this entity has the value of the address of the 
NUMBER-th formal parameter of the current frame 
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BQ := *ESCAPECHAR ( »Q / »q) 

this entity has the value of the most recently 
displayed cell 

BR := *ESCAPECHAR ( 'R / »r) 

this entity has the value of the return address for 
the current frame 

BY := *ESCAPECHAR ( 'Y / »y) 

this entity has the value of the most recently 
completely evaluated EXPRESSION 



17 
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Assigning To Address Lists 



2e5 

Many commands allow the user to assign to an address 
list as it is being displayed. The specifying of new 
values to be assigned is handled tfy the @NVLRUL 
discussed below. 
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Two Special Characters ! 2f 

There are two characters used by DAD as pseudo-interrupts 
(PSI) that need a separate discussion. The specific 
characters are initiallized to <CONTROL-L> and <C0NTR0L-K>, 
but may be changed by the user by using the Interrupt 
command . x 

The first of these characters (initiallized to <C0NTR0L-L>) 
is used to get the user to base command mode in DAD. For 
example, if a user has inadvertently requested DAD to 
display a large number of cells. Upon realizing the 
mistake, the user may type 2 <C0NTR0L-L>s to abort output 
and return to base command mode. Additionally, when tools 
are executing (i.e. after the user has given the Continue 
command) , if the user wishes to return to DAD, the user 
should type one or two <CONTROL-L>s . Since this character 
is set up as a deferred PSI, it will not take effect until 
the character is read if only one <C0NTR0L-L> is typed. If 
the user wishes immediate action, then 2 <C0NTR0L-L>s 
should be typed. (Note that in the case of aborting DAD 
output it may still take a while until the current contents 
of the output buffers are empty.) 

The second of these special characters (initiallized to 
<C0NTR0L-K>) is used to display a short status of tools 
while they are executing (i.e. after the user has given the 
Continue command) . 
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Command Summary ! 3 

Debug Command ! 3a 

Overview 

The debug command is used to point DAD at a target 
process. Once DAD is pointed at a target process, the 
full compliment of DAD commands becomes available. 

Syntax 

Debug (tool) @T00LSPEC OK: 

T00LSPEC Rule ! 



If DAD does not know about any tools yet (as when DAD 
is first started, or after the user has given the 
Done command for all active tools): 

~TENEX-FILE-NAME: 

If DAD does know about some processes: 

@ACTIVET00LS: 

"IDH: 

OPTION "TENEX-FILE-NAME: 

this path allows the user to have one or more 
parallel processes executing under DAD 

ACTIVETOOLS Rule 

the FE maintained rule of the usenames for the tools 
the user is currently debugging 
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Done Command 



! 3b 



Overview 

When the user is done debugging a tool, he/she should 
issue the Done command. Upon receiving a Done command, 
DAD will do whatever cleanup is necessary with respect 
to DAD's knowledge of the tool. If the user was 
debugging only one tool, or three or more tools, then 
DAD will ask the user to specify which tool should 
become the current target tool upon completing the Done 
command . 

Syntax 

Done (debugging tool) @ACTIVET00LS OK: 

ACTIVET00LS Rule 

see the Debug command 



21 



KEV 19-Feb-77 10:36 29116 
14 Feb 77 4Th Draft: Users' Guide To Dad 

Command Summary 
Quit Command 



Quit Command ! 3c 

Overview 

The Quit command is used to terminate a DAD debugging 
session and to return the user to the TENEX EXEC. 



Syntax 

Quit (debugging session) OK: 
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Interrupt Command ! 3d 

Overview 

The interrupt command is used to change which characters 
will serve the 2 special functions of returning to DAD'S 
base command mode and to display the status of executing 
tools . 

Syntax 



Interrupt Executing (programs & abort output character 
should be) "ICHARACTER OK: 

This path allows the user to specify which character 
will be used to return the user to base command mode. 

Interrupt Status (character should be) "ICHARACTER OK: 

This path allows the user to specify which character 
will be used to display the status of executing 
tools . 

ICHARACTER Selector 

Any control character not currently serving any other 
function . 
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Wheel Command ! 3e 

Overview 

The Wheel command is used by DAD implementers and 
maintainers for the debugging and development of DAD. 
Issuing the Wheel command makes available commands not 
normally available. The Wheel command requires the 
knowledge of a special password. It is mentioned here 
only because it may show up in response to a 
questionmark (?) typed to see the alternatives 
available. 
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Status Command ! 3f 

Overview 

The Status commands display the status of the debugger 
to the user. 

Syntax 

Status OK: 

Status Verbose OK: 

This command provides more information about each 
tool being debugged than the default Status command. 

Status For (tool) OK: 

This command provides information about the current 
tool . 

Status Verbose For (tool) OK: 

This command provides verbose information about the 
current tool. 

Status For (tool) ~IDH OK: 

This command provides information for the specified 
process. 

Status Verbose For (tool) "IDH OK: 

This command provides verbose information for the 
specified process. 
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Comment .Command ! 3g 

Overview 

This command is used to allow comments to appear on a 
typescript, etc. 

Syntax 

Comment "CTEXT: 
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Character Command i 3h 

Overview 

These commands are used either to display which 
characters are serving which generic functions, or to 
modify which character is to serve a specific generic 
function . 

Syntax 

Character (set definitions) Display OK: 

This command is used to determine which characters 
are serving which generic functions. Non-standard 
definitions will appear first in the resulting 
display . 

Character (set definitions) Use "FCHARACTER (instead of) 
@CHARRULE OK: 

This command is used to change which character will 
serve a specific generic function. 



CHARRULE Rule 

"*PLUSCHAR" (for addition): 

"*MINUSCHAR" (for subtraction): 

"*TIMESCHAR" (for multiplication): 

"*DIVIDECHAR M (for division): 

"*LPARENCHAR" (for arithemetic groupting left 
delimiter) : 

M *RPARENCHAR" (for arithemetic groupting right 
delimiter) : 

M *BLOCKCHAR" (for symbol block delimiter): 

M *FIELDCHAR" (for record field delimiter): 

M *ESCAPECHAR" (for builtin variable escape): 

"*LMCHAR" (for language module escape character): 
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,f *SEMIC0L0NCHAR" (for address list delimiter): 

rt *C0MMACHAR" (for address range delimiter): 

M *EQUALCHAR" (for display value): 

"*SLASHCHAR ,T (for display using permanent typeout 
mode) : 

"*LSQUARECHAR" (for display numerically): 

"*BSLASHCHAR" (for display as a string): 

"*RSQUARECHAR M (for display as a record): 

"*EXCMARKCHAR" (for display in ascii): 

"*QMARKCHAR" (for tell where this symbol is defined): 

"*LARR0WCHAR" (for assignment): 

"*LFCHAR" (for move to next address): 

"*UPARROWCHAR" (for move to previous address): 

M *TABCHAR" (for move to addressed address): 

"*P0UNDCHAR" (for move to previously displayed 
address) : 
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Input Command ! 3i 

Overview 

This command is used to display or change the permanent 
input mode. 



Syntax 

Input (mode) Display OK: 
Input (mode) §INPTYP OK: 
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Typeout Command ! 3j 

Overview 

This command is used to display or change the permanent 
output mode. 

Syntax 

Typeout (mode) Display OK: 

Typeout (mode) 0OUTTYP OK: 
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Symbol Command I 3k 

Overview 

A process may have more than one symbol table. (For 
example, if different parts of the address space were 
compiled and loaded as distinct entities.) The symbol 
commands allow the user to tell the debugger of the 
location of the symbol tables. When the debugger, and 
the appropriate Language Module, is first pointed at a 
process, the LM will use the default location for 
finding the symbol table. 

The debugger makes its own copy of the process' symbol 
table. Thus, if a process modifies its symbol table, it 
is necessary for the user to give a new Symbol command. 
(Ultimately this will be do-able programmatically . ) 

If a process contains more that one symbol table then 
the user can point the debugger to different tables by 
use of the symbol command and the debugger will copy the 
symbol table the frist time it is pointed to a new 
location. However, if subsequently, a user points the 
debugger to a location previously used, the debugger 
will use its own copy of the symbol table from that 
location unless the user specifies that there is a new 
pointer at the location. 

Syntax 

Symbol (table) Display (status) OK: 

This command will display which symbol tables the 
debugger knows about and will indicate which is the 
current symbol table and will provide an overview of 
the current table. 

Symbol (table) Pointer (located at) "SYMADR OK: 

Symbol (table) Pointer (located at) "SYMADR OPTION 
(undefined symbol table pointer located at) "SYMADR OK: 

These 2 commands will point the debugger to the 
symbol (and udefined symbol) table(s) at the 
specified location . If the debugger already has a 
copy of the symbol table at the specified location, 
it will not copy the process' table. 
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Symbol (table) Pointer (located at) OPTION (new pointer 
at) ~SYMADR OK: 

Symbol (table) Pointer (located at) OPTION (new pointer 
at) "SYMADR OPTION (undefined symbol table pointer 
located at) "SYMADR OK: 

These 2 commands will point the debugger to the 
symbol (and udefined symbol) table(s) at the 
specified location. This version of the command will 
force the debugger to make a copy of the specified 
symbol table(s) regardless of whether or not it 
already has a copy of the symbol table at the 
specified location. This is useful if a process has 
modified its symbol table, or if a process is 
performing its own swapping in its address space. 
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Breakpoint Command ! 31 



Overview 



The breakpoint command allows the user to specify that 
the debugger (conditionally) be entered just prior to 
the execution of an instruction at a specified address 
in a target process. 

A breakpoint is said to be "hit" when the instruction at 
the address specified for the breakpoint is about to be 
executed. After a breakpoint is hit, it either "takes" 
and the debugger is entered, or it doesn't take and 
normal execution of the target process continues. 

For each case, i.e. the breakpoint taking or not, the 
user may specify a string that will be fed to the 
debugger, as if the user typed it, when the 
breakpoint is hit. 

The decision as to whether or not a breakpoint takes is 
based on the following algorithm: 

If a user has specified a procedure to be called when 
a breakpoint is hit, this procedure is called and 
returns one of three values: take the breakpoint, 
don't take the breakpoint, or base the decision on 
the proceed mode and counter. If this procedure 
returns the third value, or if no procedure was 
specified, then the breakpoint will take if the 
proceed mode is normal or automatic or if the proceed 
mode is count and this breakpoint has been hit count 
times already without taking. 

Every breakpoint that is set, i.e. for which an address 
has been specified, has the following attributes 
associated with it: 

a) its number, "BTNUMBER 

When a breakpoint is first set, the user can 
request a specific number, or let the debugger 
assign an unused number for the breakpoint. 

The user uses this number when he or she wishes to 
modify or examine the status of the breakpoint. 
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b) its address, "BTADDRESS 

This is the address at which the breakpoint is 
set. 

Note that specifying an address for a breakpoint 
that is already set is equivalent to first 
clearing that breakpoint and then setting the 
address . 

c) its name, ~BRNAME 

If and when a breakpoint takes, its name will be 
displayed. A name is simply a string (including 
the null string) used for information purposes 
only. If a user is debugging more than one 
process, he or she may choose to name the 
breakpoints set in each process with the 
appropriate process name. Names need not be 
unique . 

d) its proceed mode 

Every set breakpoint has one of three proceed 
modes : 

Normal mode 

Set either by default or by specify a 
proceed count of zero. 

In this mode, the breakpoint will take each 
time the breakpoint is hit. 

Automatic proceed mode 

Set by specifying proceed automatically. 

In this mode, the breakpoint will take each 
time the breakpoint is hit and then the 
breakpoint will be continued automatically, 
after processing its take command string if 
one exists. 

Count mode 

Set by specifying a non-zero proceed count. 
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In this mode, the breakpoint will not take 
until the breakpoint has been hit count plus 
one times. If a no take command string 
exists, then the count times this breakpoint 
is hit before it takes, the no take command 
string will be executed. 

e) its call procedure, ~PNAME - NOT IMPLEMENTED YET 

f) its take command string 

When a breakpoint takes, if this string is 
non-null it will be fed to the debugger as if the 
user entered it on his or her terminal prior to 
accepting input from the user or automatically 
continuing . 

g) and its no take command string 

If a breakpoint doesn't take, and if this string 
is non-null it will be fed to the debugger as if 
the user entered it on his or her terminal when 
the breakpoint is hit and prior to continuing the 
breakpoint . 

Syntax 

Breakpoint Display (all) OK: 

This command will display the status of all 
breakpoints that are currently set. 

Breakpoint "BTNUMBER Display OK: 

This command will display the status of breakpoint 
~BTNUMBER. 

Breakpoint Clear (all) OK: 

This comand will clear all breakpoints, i.e. make 
them not set. 

Breakpoint "BTNUMBER Clear OK: 

This command will clear breakpoint "BTNUMBER. 

Breakpoint Set (at) "BTADDRESS @B0PT: 
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Breakpoint "BTNUMBER Set (at) "BTADDRESS- @B0PT: 

These two commands will set a breakpoint at the 
specified address, and will set any of the attributes 
specified. If "BTNUMBER is not specified, then the 
debugger will assign a number for this breakpoint. 
If ~BTNUMBER is specified and it refers to a 
breakpoint that is already set, then that breakpoint 
will be cleared first, and then set at the new 
address with any attributes specified in this 
instance of the command. 

Breakpoint "BTNUMBER §B0PT1: 

This command allows the user to modify the attributes 
of breakpoint "BTNUMBER. 



BOPT Rule ', 

OK: 
§B0PT1: 



B0PT1 Rule 

Call (procedure) "PNAME §BOPT: 

NOT IMPLEMENTED YET. 

This rule is used to specify the name of a 
procedure that will get called when a breakpoint 
is hit to determine whether or not to take the 
breakpoint. 

Proceed Count (=) ~PNUMBER 0BOPT: 

This rule is used to place a breakpoint in either 
normal proceed mode (if "PNUMBER is zero) or in 
count mode. 

Proceed Automatically §B0PT: 

This rule is used to place a breakpoint in the 
automatic proceed mode. 

Name (for this breakpoint is) "BRNAME @B0PT: 
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This rule is used to specify the name for a 
breakpoint . 

Break (commands are) "BRKCMNDS @B0PT: 

This rule is used to specify the take command 
string that gets executed when a breakpoint takes. 

No (break commands are) "BRKCMNDS §B0PT: 

This rule is used to specify the no take command 
string that will get executed if a breakpoint is 
hit but doesn't take. 



37 



KEV l9-Feb-77 10:36 29116 
14 Feb 77 4Th Draft: Users' Guide To Dad 

Command Summary 
Continue Command 



Continue Command ! 3m 

Overview 

The continue commands allow the user to continue the 
execution of the process(es) that were executing before 
entering the debugger (regardless of whether the 
debugger was entered via a (nested) EXEC DEBUG command 
or by the taking of a (nested) breakpoint), or to modify 
the address at which a process will have its execution 
resumed when execution is ultimately continued, and 
optionally to modify the speed with which execution will 
proceed. 

Syntax 

Continue OK: 

This command will continue whatever was going_on 
before the debugger was entered . 

Continue OPTION (address for this process is) ~CNADDRESS 
OK: 

This command will change the address at which the 
current target process will resume execution when it 
is ultimately continued. 

Continue At ~CNADDRESS OK: 

This command will change the resume address of the 
current target process and then continue what was 
going on before the debugger was entered. 

Continue At "CNADDRESS 0CNSPEED OK: 

This command will change the resume address of the 
current target process and then continue what was 
going on before the debugger was entered, at the 
specified execution speed. 

Continue (§CNSPEED OK: 

This command will continue what was going on before 
the debugger was entered, but at the newly speicifed 
speed. 
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CNSPEED Rule 

Normal (speed) : 
For (one) gSPDRULE: 
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Free Command i 3n 

Overview 

Several debugger operations require the use of free 
cells in the address space of the target process (e.g. 
breakpoint continuing, executing an instruction on the 
behalf of the target process). This command allows the 
user to specify where the debugger should get the cells 
it requires. 

Currently the debugger requires 4 cells to implement 
breakpoints. I expect that in the future when I 
implement instruction execution on the behalf of the 
target process, specifically procedure calls, the 
debugger will require as many as 2-3 dozen cells 
(depending on how many parameters are being passed); 

The cells that the debugger is currently using can be 
determined via the Verbose form of the Status command. 

Syntax 

Free (core available at) ~FCADR OK: 
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Display Command i 3o 



Overview 



This is the basic command for displaying entities 
(cells, state information, etc.) in the target process. 

Syntax 

Display "DADDRESSLIST: 

This command will display the specified address list 
in the mode specified by the "DADDRESSLIST terminator 
(and for certain values of this terminator will let 
the user modify the displayed address list) . 

DADDRESSLIST Selector 

a "DADDRESSLIST is an "ADDRESSLIST that is terminated 
by either an OK or @DTERM 

DTERM Rule 

OPTION (typeout mode) @0UTTYP OK: 

This terminator will cause the specified address 
list to be displayed in the output mode specified 
by @0UTTYP. 

OPTION (typeout mode) @0UTTYP OPTION (and assign to 
address list) OK: 

This terminator will cause the specified address 
list to be displayed in the output mode specified 
by @0UTTYP, and will allow the user to modify the 
displayed cells as they are being displayed. 

*SLASHCHAR: 

*RSQUARECHAR: 

*BSLASHCHAR: 

*LSQUARECHAR: 

*EXCMARKCHAR: 
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*QMARKCHAR: 

*EQUALCHAR: 

•LARROWCHAR: 

*TABCHAR: 

*POUNDCHAR: 

*LFCHAR: 

*UPARROWCHAR: 
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Find Command | 3p 

Overview 

The find commands allow the user to display, and 

optionally assign to, those cells in an address list 

that meet certain content requirements. The user may 

specify a mask to select those bits in a cell that he or 

she is interested in checking against similar bits in 

the value that he or she has specified. 

(In fact, each cell in the address list is logically 

ANDed with the mask and the result is then compared 

with the AND of the mask and the specified search 
value . ) 

The mask used in a reference search is one that will 
select the address field of a cell. The mask used for 
content and not content searches is the debugger default 
mask, unless the user specifies a mask for this instance 
of the command. The default debugger mask can be 
displayed and modified via the Mask command. It is 
initially set to select all bits in a cell. 

A reference and a content search will display, and 
optionally allow the user to assign to, those cells in 
the address list for which the above mentioned compare 
was equal. A not content search will display, and 
optionally assign to, those cells that compare 
unequally. 

All displayed cells will be displayed in the current 
output mode unless the user specified TADDRE.SSLIST 
terminator modifies the display. 

The user may optionally specify an input mode that will 
be used to evaluate the specified search value, ~FVALUE. 

Syntax 

Find References (to) gFSPEC (in address list) 
"FADDRESSLIST: 

This command will display, in the output mode 
specified by "FADDRESSLIST terminator, (and, if this 
terminator dictates it, assign to) those cells in the 
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specified address list whose address field is equal 
to the specified "FVALUE. 

Find Content @FSPEC (masked by) @MSPEC (in address list) 
"FADDRESSLIST: 

This command will display, in the output mode 
specified by "FADDRESSLIST terminator, (and, if this 
terminator dictates it, assign to) those cells in the 
specified address list whose selected bits, as 
specified by @MSPEC, are equal to the corresponding 
bits in the specified "FVALUE. 

Find Not (content) @FSPEC (masked by) @MSPEC (in address 
list) ~FADDRESSLIST: 

This command will display, in the output mode 
specified by "FADDRESSLIST terminator, (and, if this 
terminator dictates it, assign to) those cells in the 
specified address list whose selected bits, as 
specified my @MSPEC, are not equal to the 
corresponding bits in the specified ~FVALUE. 



FSPEC Rule 

"F VALUE: 

the search value 

OPTION (input mode) 3INPTYP (value) LVALUE: 

This rule allows the user to specify a current 
input mode that will be used to evaluate "FVALUE 
and ~MVALUE 

MSPEC Rule 

OK: 

Use the default debugger mask 

A MVALUE: 

The mask to be used for this instance of the find 
command . 

FADDRESSLIST Selector 
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a "FADDRESSLIST is an "ADDRESSLIST that is terminated 
either with an OK or @FTERM 



FTERM Rule ! 

*SLASHCHAR: 

*RSQUARECHAR: 

*EXCMARKCHAR: 

OPTION 0OUTTYP OK: 

OPTION §0UTTYP OPTION (and assign to address list) 
OK: 
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Mask Command i 3q 

Overview 

This command allows the user to examine or to modify the 
default debugger mask, which is used by the Find and 
Memory commands. 

Syntax 

Mask Display OK: 

Mask Set (to) "MVALUE OK: 

Mask Set (to) OPTION (input mode) 0INPTYP (mask value) 
"MVALUE OK: 
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Memory Command { 3r 

Overview 

The memory commands allow the user to set (selected 
bits) in all cells in the specified address list to the 
specified value. 

If the user does not specify to use a mask, then all 
bits in the pertinent cells will be affected. If the 
user specifies to use a mask, then he or she may use 
either the default debugger mask, or may specify a mask 
for this instance of the command. 

If a mask is used then only those bits selected by the 
mask will be set, and they will be set to the 
corresponding bits in the specified "MNVALUE. 

Syntax 

Memory (set to) §MNSPEC (in address list) "MADDRESSLIST: 

This command will set the selected bits in the cells 
in the specified address list to the corresponding 
bits in the specified "MNVALUE. 



MNSPEC Rule 

~MNVALUE: 

the value to set the selected bits to 

OPTION (input mode) SIMPTYP (value) ~MVALUE: 

this path allows the user to specify a current 
input mode that will be used to evaluate ~MNVALUE, 
and "MVALUE (if one is specified) 

MADDRESSLIST Selector 

a "MADDRESSLIST is an "ADDRESSLIST is terminated by 
either an OK or §MTERM 

MTERM Rule 

OPTION (masked by) OK: 
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this path indicates to use the default debugger 
mask to select bits in the address list for 
modification 

OPTION (masked by) "MVALUE OK: 

this path allows the user to specify a mask to use 
to select bits in the address list to be modified 
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Output Command ! 3s 

Overview 

The output commands give the user the capability to 
multiplex output to his or her terminal and/or to a 
sequential text file. If output is currently going only 
to a file, the user will not have the ability to modify 
cells in an address list unless the Type command is 
used. If output is going only to a terminal, the user 
can force output to a file by use of the Print command. 
When the user first specifies a file, output will be 
sent to both the file and the terminal. When specifying 
a file, the user can either specify a new file, or an 
old file to which the output should be appended. 

(Current version of the debugger uses local TENEX 
files for the output file, but ultimately this will 
be a WM file.) 

Syntax 

Output (printing) Display: 

Output (printing) Append (to file) ~OLDFILELINK OK: 

Output (printing) To (file) "NEWFILELINK OK: 

Output (printing) Off OK: 

Output (printing) Both (to file and terminal) OK: 

Output (printing) Soley (to) File (and not to terminal) 
OK: 

Output (printing) Soley (to) Terminal (and not to file) 
OK: 
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Print Command ! 3t 

Overview 

This command is used to display the specified address 
list on the specified file. If there is already a 
specified output file, then this is the one that will be 
used, and the user will not be asked to specify a file. 

(Note that when using this command, it is not 
possible to modify the cells as they are being 
displayed since they will be displayed on an output 
file and not on hte user's terminal. Useful for core 
dumps, among other uses!) 

Syntax 

Print ~PADDRESSLIST: 

This command will display the specified address list 
on the current output file in the mode specified by 
"PADDRESSLIST terminator. 

Print (on file) "NEWFILELINK "PADDRESSLIST: 

This command will display the specified address list 
on the specified output file in the mode specified by 
"PADDRESSLIST terminator. 

PADDRESSLIST Selector ! 

a "PADDRESSLIST is an "ADDRESLIST terminated by 
either an OK or §PTERM 

PTERM Rule { 

OPTION (typeout mode) §0UTTYP OK: 

*SLASHCHAR: 

*RSQUARECHAR: 

*BSLASHCHAR: 

*LSQUARECHAR: 

*EXCMARKCHAR: 
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*QMARKCHAR: 

*EQUALCHAR: 

*TABCHAR: 

*POUNDCHAR: 

*LFCHAR: 

*UPARROWCHAR: 
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Type Command ! 3u 

Overview 

This command is used to display the specified address 
list (in the specified mode) on the user's terminal 
regardless of his output file settings. 



Syntax 

Type ~DADDRESSLIST: 

(See the Display command.) 
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Command Summary 
Value Command 



Value Command i 3v 

Overview 

This command is equivalent to: 

Display ~ADDRESSLIST *EQUALCHAR: 

Syntax 

Value (of) "VADDRESSLIST: 

VADDRESSLIST SELECTOR 

a "VADDRESSLIST is an "ADDRESSLIST terminated by 
either an OK or §VTERM 

VTERM Rule ! 



*EQUALCHAR: 
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Command Summary 
Speed Command 



Speed Command i 3w 

Overview 

The speed command allows the user to modify the 
execution speed of the current process. The execution 
speed can be modified so that the process will execute 
in a single step mode (a single machine or language 
instruction at a time) ; and/or to treat an entire called 
procedure as if it were one instruction; and/or to 
execute until a branch or transfer instruction is 
encountered; and/or to continue automatically after 
entering the debugger and notifying the user because one 
of the above conditions has been met. 

Syntax 

Speed (of execution) Normal OK: 

This command resets the execution speed for the 
current process back to normal speed. 

Speed (of execution) Single @SPDRULE: 

This command allows the user to modify the execution 
of the current process. 
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Command Summary 
GFC *BSLASHCHAR Command 



*BSLASHCHAR Command ! 3x 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *BSLASHCHAR: 
Syntax 

"*BSLASHCHAR": 
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Command Summary 
GFC *EQUALCHAR Command 



*EQUALCHAR Command ! 3y 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *EQUALCHAR: 
Syntax 

"*EQUALCHAR" : 
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Command Summary 
GFC *EXCMARKCHAR Command 



*EXCMA-RKCHAR Command i 3z 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *EXCMARKCHAR: 
Syntax 

"*EXCMARKCHAR": 
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Command Summary 
GFC *LSQUARECHAR Command 



*LSQUARECHAR Command ! 

3aa 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *LSQUARECHAR: 
Syntax 

"*LSQUARECHAR": 
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Command Summary 
GFC *RSQUARECHAR Command 



*RSQUARECHAR Command ! 

3ab 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *RSQUARECHAR : 
Syntax 

"*RSQUARECHAR": 
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Command Summary 
GFC *QMARKCHAR Command 



*QMARKCHAR Command 



3ac 
Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *QMARKCHAR: 

Syntax 

"♦QMARKCHAR": 
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Command Summary 
GFC *SLASHCHAR Command 



*SLASHCHAR Command ! 

3ad 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *SLASHCHAR: 
Syntax 

"*SLASHCHAR»: 
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Command Summary 
GFC *LARROWCHAR Command 



*LARROWCHAR Command ! 

3ae 

Overview 

This command is equivalent to: 

Display *ESCAPECHAR Z *LARROWCHAR: 
Syntax 

"*LARROWCHAR" : 
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Command Summary 
GFC *UPARROWCHAR Command 



*UPARROWCHAR Command 1 

3af 
Overview 

This command is equivalent to: 

Display *ESCAPECHAR A - 1: 

Syntax 

M *UPARROWCHAR M : 
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Command Summary 
GFC *LFCHAR Command 



*LFCHAR Command ! 

3ai 
Overview 

This command is equivalent to: 

Display *ESCAPECHAR A + 1: 

Syntax 

"*LFCHAR": 
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Command Summary 
GFC *TABCHAR Command 



*TABCHAR Command ! 

3ah 

Overview 

This command is equivalent to: 
Display *ESCAPECHAR Q: 
Syntax 

"*TABCHAR": 
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Command Summary 
GFC *POUNDCHAR Command 



*POUNDCHAR Command ! 

3ai 
Overview 

This command is the inverse for the last Tab, Linefeed, 
Uparrow, or Pound command. 

Syntax 

"*POUNDCHAR»: 
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Common Rules 
BASE Rule 

Decimal : 

Octal : 

Hex: 

Binary : 
INPTYP Rule 

Ascii : 

Bytes (with bytesize of) "BSVALUE: 

Floating (point numbers) : 

Rad50: 

Radix "RXVALUE: 

Radix @BASE: 

Sixbit: 

Symbolic : 
OUTTYP Rule 

Addresses (as) Absolute (values): 

Addresses (as) Symbolic (values): 

Array: 

Ascii: 

Bytes (with bytesize of) "BSVALUE: 

Floating (point numbers): 

List: 

Numeric: 



3aj 
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Command Summary 
Common Rules 



Rad50: 

Radix "RXVALUE: 

Radix §BASE: 

Records (of name) "RNAME: 

Sixbit: 

String : 

Symbolic : 

NVLRUL Rule 

CD: 

abort the display of, and assignment to, this address 
list 

OK: 

accept the displayed value of this entity 

~NVALUE OK: 

replace the value of the displayed entity with 
"NVALUE, which will be interpretted according to the 
current input mode 

OPTION (input mode) §INPTYP (new value) "NVALUE OK: 

replace the value of the displayed entity with 
"NVALUE, which will be interpretted according to the. 
specified input mode 

§MOVRUL: 

~NVALUE §M0VRUL: 

OPTION (input mode) 0INPTYP (new value) ~NVALUE §M0VRUL: 

the above 3 paths allow the user to terminate the 
(optionally) newly specified value (for the displayed 
entity) with the @M0VRUL paths. When the display of, 
and assignment to, the specified address list is 
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Command Summary 
Common Rules 



finished, the last specified 0MOVRUL path will take 
effect as if the user had given the GFC command 
corresponding the the §MOVRUL path 



MOVRUL Rule 

*TABCHAR: 

*POUNDCHAR: 

•L.FCHAR: 

*UPARROWCHAR: 

SPDRULE Rule 

In the following, the ordering of gSPDPROC, @SPDEXEC, 
and §SPDCONT, is not important, and 0, 1, 2, or all 3 of 
the rules may appear. 

§SPDTYPE OK: 

@SPDTYPE §SPDPR0C OK: 

@SPDTYPE gSPDEXEC OK: 

0SPDTYPE gSPDCONT OK: 

§SPDTYPE 0SPDPROC §SPDEXEC OK: 

@SPDTYPE gSPDPROC 0SPDCONT OK: 

@SPDTYPE gSPDEXEC @SPDC0NT OK: 

@SPDTYPE gSPDPROC SSPDEXEC §SPDCONT OK: 

SPDCONT Rule 

Proceed (automatically after each instruction): 

This rule allows the user to continue automatically 
after entering the debugger because some single 
stepping mode condtion has been met. 
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Command Summary 
Common Rules 



SPDEXEC Rule 

Execute (until branch point or transfer instruction) : 

This rule allows the user to have execution of the 
process continue until a branch or transfer 
instruction is encountered. 

SPDPROC Rule 

Treat (called procedures as one instruction): 

This rule allows tge user to treat a called procedure 
as one instruction rather than as a series of 
instructions. 

SPDTYPE Rule 

Language (instruction): 

This rule means to deal with instructions at the high 
level language level as opposed to at the machine 
level . 

Machine (instruction): 

This rule means to deal with instructions at the 
machine level as opposed to at the high level 
language level. 
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29116 



Selectors 

In the following discussion an expression is really a text 
selector that conforms to the rules for expression 
generation for the current language being used by the 
debugger . 

ADDRESSLIST Selector 

text that conforms to the formal definition of an 
address list (see above) 

BRKCMNDS Selector 

any text 
BRNAME Selector 

any text 
BSVALUE Selector 

a number in the current input mode radix 
BTADDRESS Selector 

an expression that evaluates to an address 
BTNUMBER Selector 

a number in the current input mode radix 
CNADDRESS Selector 

an expression that evaluates to an address 
CTEXT Selector 

any text 
FCADR Selector 

a number in the current input mode radix 



3ak 
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FCHARACTER Selector 

a single non-alphanumeric character 
FVALUE Selector 

an expression 
IDH Selector 

a number in the current input mode radix 
MNVALUE Selector 

an expression 
MVALUE Selector 

an expression 
NEWFILELINK Selector 

an new file name string 
NVALUE Selector 

any text 
OLDFILELINK Selector 

an old (pre-existing) file name string 
PNAME Selector 

an expression that evaluates to an address 
PNUMBER Selector 

a number in the current input mode radix 

RNAME Selector 

an expression that evaluates to the address of a record 
descriptor 
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RXVALUE Selector 

a base ten number 
SYMADR Selector 

a number in the current input mode radix 
TENEX-FILE-NAME Selector 

a full TENEX file name 
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Appendix I - L10 'Cheat' Card ! 
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Appendix II - Alphabetical List of Commands, Rules, and Selectors ' 5 
Commands i 



"*BSLASHCHAR": page 55 i 

"*EQUALCHAR": page 56 ! 

"*EXCMARKCHAR»: page 57 

"*LARR0WCHAR": page 62 

"*LFCHAR": page 64 

"*LSQUARECHAR": page 58 

"*POUNDCHAR": page 66 

"*QMARKCHAR": page 60 

"*RSQUARECHAR": page 59 

"*SLASHCHAR": page 61 

"*TABCHAR": page 65 

"*UPARR0WCHAR»: page 63 



Breakpoint Commands page 33 

Breakpoint Set (at) "BTADDRESS @B0PT: 

Breakpoint "BTNUMBER Set (at) A BTADDRESS @B0PT: 

Breakpoint Clear (all) OK: 

Breakpoint "BTNUMBER Clear OK: 

Breakpoint Display (all) OK: 

Breakpoint "BTNUMBER Display OK: 

Breakpoint "BTNUMBER @B0PT1: 

Character Commands page 27 

Character (set definitions) Display OK: 
Character (set definitions) Use "FCHARACTER 
(instead of) @CHARRULE OK: 

Comment "CTEXT: page 26 



Debug (tool) §T00LSPEC OK: page 20 

Display ~DADDRESSLIST: page 41 

Done (debugging tool) @ACTIVET00LS OK: -» page 21 
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Continue Commands page 38 ! 

Continue OK: i 

Continue At "CNADDRESS OK: ! 

Continue gCNSPEED OK: j 

Continue At "CNADDRESS 0CNSPEED OK: ! 

Continue OPTION (address for this process is) ! 

~CNADDRESS OK: ! 
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Find Commands page 43 

Find Content §FSPEC (masked by) §MSPEC 

(in address list) ~FADDRESSLIST: 
Find Not (content) §FSPEC (masked by) @MSPEC 

(in address list) ~FADDRESSLIST: 
Find References (to) §FSPEC 

(in address list) TADDRESSLIST: 

Free (core available at) "FCADR OK: page 40 

Input Commands page 29 

Input (mode) Display OK: 
Input (mode) §INPTYP OK: 

Interrupt Commands page 23 

Interrupt Status (character should be) "ICHARACTER OK: 
Interrupt Executing (programs & abort output character 
should be) A ICHARACTER OK: 



Mask Commands 

Mask Display OK: 
Mask Set (to) "MVALUE OK: 

Mask Set (to) OPTION (input mode) 0INPTYP 
(mask value) ~MVALUE OK: 



page 46 



Memory 



(set to) gMNSPEC (in 
~MADDRESSLIST: — 



address list) 



page 47 



Output Commands 

Output (printing) 



Output 
Output 
Output 
Output 
Output 

Output 



(printing) 
(printing) 
(printing) 
(printing) 
(printing) 

OK: 
(printing) 

OK: 



page 49 

Off OK: 

Display: 

To (file) "NEWFILELINK OK: 

Append (to file) "OLDFILELINK OK: 

Both (to file and terminal) OK: 

Soley (to) File (and not to terminal) 

Soley (to) Terminal (and not to file) 



Print Commands 

Print A PADDRESSLIST: 

Print (on file) "NEWFILELINK 



PADDRESSLIST: 



Quit (debugging session) OK: 



page 50 



page 22 
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Speed Commands page. 54 

Speed (of execution) Normal OK: 
Speed (of execution) Single £SPDRULE: 

Status Commands page 25 

Status OK: 

Status Verbose OK: 

Status For (tool) OK: 

Status For (tool) ~IDH OK: 

Status Verbose For (tool) OK: 

Status Verbose For (tool) ~IDH OK: 

Symbol Commands page 31 

Symbol (table) Display (status) OK: 

Symbol (table) Pointer (located at) ~SYMADR OK: 

Symbol (table) Pointer (located at) "SYMADR OPTION 

(undefined symbol table pointer 

located at) "SYMADR OK: 
Symbol (table) Pointer (located at) OPTION 

(new pointer at) ~SYMADR OK: 
Symbol (table) Pointer (located at) OPTION 

(new pointer at) "SYMADR OPTION 

(undefined symbol table pointer 

located at) "SYMADR OK: 

Type ~DADDRESSLIST: page 52 

Typeout Commands page 30 

Typeout (mode) Display OK: 
Typeout (mode) 0OUTTYP OK: 

Value (of) "VADDRESSLIST: page 53 
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Rules 



ACTIVETOOLS Rule page 20 

BASE Rule page 67 

BOPT Rule page 36 

BOPT1 Rule . page 36 

CHARRULE Rule page 27 

CNSPEED Rule page 38 

DTERM Rule page 41 

FSPEC Rule page 44 

FTERM Rule page 45 

INPTYP Rule page 67 

MNSPEC Rule page 47 

MOVRUL Rule page 69 

MSPEC Rule page 44 

MTERM Rule page 47 

NVLRUL Rule page 68 

OUTTYP Rule ' page 67 

PTERM Rule page 50 

SPDCONT Rule page 69 

3PDEXEC Rule page 70 

SPDPROC Rule page 70 

SPDRULE Rule — page 69 

SPDTYPE Rule page 70 

TOOLSPEC Rule page 20 

VTERM Rule page 53 



78 



Appendix II - 



14 Feb 77 
Alphabetical List 



4Th Draft: 
of Commands 



KEV 19-Feb-77 10:36 29116 
Users 1 Guide To Dad 
Rules, and Selectors 
Selectors 



Selectors 

ADDRESSLIST Selector page 71 

BRKCMNDS Selector page 71 

BRNAME Selector page 71 

BSVALUE Selector page 71 

BTADDRESS Selector page 71 

BTNUMBER Selector — page 71 

CNADDRESS Selector page 71 

CTEXT Selector page 71 

DADDRESSLIST Selector page 41 

FADDRESSLIST Selector page 44 

FCADR Selector page 71 

FCHARACTER Selector page 72 

FVALUE Selector page 72 

ICHARACTER Selector page 23 

IDH Selector page 72 

MADDRESSLIST Selector page 47 

MNVALUE Selector page 72 

MVALUE Selector page 72 

NEWFILELINK Selector page 72 

NVALUE Selector page 72 

OLDFILELINK Selector page 72 

PADDRESSLIST Selector page 50 

PNAME Selector page 72 

PNUMBER Selector page 72 

RNAME Selector ■ — page 72 

RXVALUE Selector page 73 

SYMADR Selector page 73 

TENEX-FILE-NAME Selector page 73 
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